home *** CD-ROM | disk | FTP | other *** search
/ Software Vault: The Gold Collection / Software Vault - The Gold Collection (American Databankers) (1993).ISO / cdr26 / pwrutls2.zip / README < prev    next >
Text File  |  1993-06-03  |  14KB  |  317 lines
  1.      INTRODUCTION
  2.      ------------
  3.      Congratulations!  As a new or renewing PC/Computing subscriber,
  4.      we've sent you the all new, state-of-the-art PC/Computing
  5.      Utilities never before available in diskette form, complete with 
  6.      their own handy, self-documenting, user-friendly shell program.
  7.  
  8.      Now, instead of having to rely on the somewhat cryptic
  9.      filenames, or pages of a printed manual, simply call up
  10.      Michael J. Mefford's incredible shell by typing PCCx (where
  11.      x=the Utilities volume number)!  The program names and their
  12.      descriptions and documentation are all right there on the screen.
  13.      Once you've chosen a utility and read about how it works, press
  14.      enter, type in any appropriate parameters, and hit enter again.
  15.      The utility will execute, and any key will return you to the
  16.      PCC shell.
  17.  
  18.      We think this innovative presentation will allow you to get even
  19.      more use out of "the utilities that DOS forgot."  Print out this
  20.      file and read it once to know all you need to know.  Most of you
  21.      will find PCC1.COM a great program just the way it is.  The more
  22.      enterprising among you will want to create your own custom
  23.      versions of the shell using PCCNDX.COM (see below).  And press
  24.      F2 at any time while within the shell to see how you can log onto
  25.      ZiffNet, PC/Computing's interactive reader service.
  26.  
  27.      BACKUP
  28.      ------
  29.      Before you do anything else, make a backup copy of this disk.
  30.      The PCCNDX.COM program on this disk is capable of altering the
  31.      PCC1 shell program.  Having a backup copy will insure that you
  32.      can always retrieve the original program files.  To make a
  33.      backup, place an empty formatted disk in drive B:, put this
  34.      disk in drive A: and enter:
  35.  
  36.      COPY A:\*.* B:
  37.  
  38.      This will create an exact duplicate of this disk, that will now
  39.      be in your B: drive.
  40.      *****************************************************************
  41.  
  42.      PRINT THIS FILE
  43.      ---------------
  44.      To print a copy of this README file, turn on your printer and
  45.      enter:
  46.  
  47.      COPY A:\README PRN
  48.      *****************************************************************
  49.  
  50.      INSTALL
  51.      -------
  52.      To install the programs from this disk onto a hard disk, create
  53.      a directory and then copy all the files to the new directory.  We
  54.      suggest that you use a directory named PCC, but you can use
  55.      any name that suits you.  If you are going to install the disk on
  56.      drive C:, for example, and this floppy disk is in drive A, you
  57.      would first enter
  58.  
  59.      MD C:\PCC
  60.  
  61.      And copy the files to the newly created directory by entering:
  62.  
  63.      COPY A:\*.* C:\PCC
  64.      *****************************************************************
  65.  
  66.      ADD PATH
  67.      --------
  68.      It's not necessary for you to add the PCC directory to the PATH
  69.      statement in your AUTOEXEC.BAT, but we recommend that you do.
  70.      The reason for this is so that DOS can find and execute the PCC
  71.      shell and utilities no matter where on your hard drive you happen
  72.      to be working.
  73.  
  74.      The quickest way to add or modify a PATH statement is with the
  75.      DOS line editor called EDLIN, but you can use any word processor
  76.      capable of saving a file in ASCII format.  To edit with EDLIN
  77.      start with the command:
  78.  
  79.      EDLIN \AUTOEXEC.BAT
  80.  
  81.      (If EDLIN is not found you will get a "Bad file or command".  If
  82.      that is the case the most likely place you can find EDLIN is in a
  83.      \DOS directory.  First change to the DOS directory by entering
  84.  
  85.      CD \DOS
  86.  
  87.      and then try to load EDLIN again.)
  88.  
  89.      Once you successful have EDLIN loaded you will either see the
  90.      statement
  91.  
  92.      End of Input file
  93.  
  94.      if you already have an AUTOEXEC.BAT or
  95.  
  96.      New file
  97.  
  98.      if an AUTOEXEC.BAT does not already exist.
  99.  
  100.      If you find that you already have an AUTOEXEC.BAT, do the
  101.      following:  At the EDLIN prompt (an asterisk: "*"),  enter the
  102.      List Lines command:
  103.  
  104.      L
  105.  
  106.      If you see a line starting with the word PATH, enter the number
  107.      that prefaces that line and press F3.  The desired PATH statement
  108.      should appear on two lines with the cursor at the end of the
  109.      second line.  To add the new path enter at the cursor
  110.  
  111.      ;C:\PCC
  112.  
  113.      Don't forget the delimiting starting semicolon.  To save the
  114.      edited changes, enter
  115.  
  116.      E
  117.  
  118.      for End Edit and that is all there is to it.  The edited
  119.      AUTOEXEC.BAT will be saved to disk.
  120.  
  121.      If you don't see the PATH command or you got the "New file"
  122.      message you can add a PATH statement with the EDLIN insert
  123.      command by entering the following:
  124.  
  125.      I1
  126.  
  127.      That's the letter I followed by the number 1 (meaning Insert at
  128.      line 1).  At the "1:*" prompt enter
  129.  
  130.      PATH=C:\PCC
  131.      (Of course,  if you use a drive other than C or directory other
  132.      than PCC, substitute those values in the above instructions.)
  133.  
  134.      After pressing Enter, the prompt, "2:*", for the next line
  135.      will appear.  Press Ctrl-C to exit EDLIN's insert mode by holding
  136.      down the Ctrl key and pressing C.  Save the new AUTOEXEC.BAT file
  137.      to disk with the End Edit command:
  138.  
  139.      E
  140.  
  141.      If at anytime you want to abort the editing process, enter at
  142.      the "*" prompt:
  143.  
  144.      Q
  145.  
  146.      for Quit Edit.
  147.  
  148.      Otherwise, the next time you boot, the edited AUTOEXEC.BAT will
  149.      set the PATH=C:\PCC so DOS can find the PCC shell and utility
  150.      files.
  151.      *****************************************************************
  152.  
  153.      SETTING UP A BATCH FILE
  154.      -----------------------
  155.      Instead of adding C:\PCC to the PATH, you can set up a batch
  156.      file to change to the PCC shell directory.  Create a batch file
  157.      with the name PCC.BAT, for example, with the following
  158.      instructions.
  159.  
  160.      C:
  161.      CD \PCC
  162.      PCCx       (where x is the volume number)
  163.      CD \
  164.      *****************************************************************
  165.  
  166.      PCC SHELL
  167.      -----------
  168.      The PCC shell program on this disk has the name PCCx (where x
  169.      is the volume number of the utilities found on this disk).  For
  170.      example, the first volume of the shell program is named
  171.      PCC1.COM.  There is also a matching overlay program with the
  172.      name PCCx.OVL.  This will be PCC1.OVL for the PCC1.COM
  173.      program.
  174.  
  175.      To run the shell program, enter the command PCCx at the DOS
  176.      prompt (again, replacing x with the version of the shell that
  177.      you have).
  178.  
  179.      To the left of the PCC menu is a listing of all of the names of
  180.      the PC/Computing utilities found on this disk.  To the right of
  181.      the listing is a description of the utility currently highlighted
  182.      by the selection bar.  Use the cursor navigation keys (the up and
  183.      down arrow keys and PgUp, PgDn, Home and End keys) to scroll
  184.      through the utilities in the listing window.  As you move the
  185.      selection bar the full description of each utility will appear in
  186.      the window to the right.
  187.  
  188.      To activate the description window, press the right arrow key or
  189.      the tab key.  The description window will become illuminated.
  190.      You can then use the cursor navigation keys to browse through the
  191.      description.
  192.  
  193.      Return to the listing window to select another utility by
  194.      pressing the left arrow key or the tab key.  Press Esc at anytime
  195.      to quit the PCC shell program and return to DOS.  Press F1 at
  196.      anytime for a summary of the PCC instructions in this README
  197.      file.
  198.  
  199.      Run the currently selected utility while either the listing
  200.      window or description window is active by pressing Enter.  A
  201.      parameters window at the top of the menu will become active.
  202.      Enter any necessary parameters indicated in the utility
  203.      description window and press Enter again.
  204.  
  205.      The PCC shell program supports any number of display lines,
  206.      including the popular 43 line EGA mode and the 50 line VGA mode.
  207.      The PCCNDX described below enables you to created a customized
  208.      PCC shell with filenames and descriptions of your own.
  209.  
  210.      If at any time you don't understand what to do, F1 will bring up a 
  211.      concise, informative help screen.
  212.      *****************************************************************
  213.  
  214.      PCCNDX
  215.      --------
  216.      PCCNDX.COM allows you to create a custom PCC shell of your
  217.      own.  This can include any combination of PC/Computing Utilities
  218.      (selected from this volume, another volume, or downloaded from
  219.      ZiffNet).  It can also include utilities from other
  220.      collections, such as commercial disk-management tools or
  221.      programs you have written yourself.
  222.  
  223.      You need never run PCCNDX in order to use the utilities
  224.      provided on this disk.  If you do not want to make a customized
  225.      shell, you can simply copy the files named PCCx.COM and
  226.      PCCx.OVL from your backup disk to your working diskette or hard
  227.      drive and you're ready to go.
  228.  
  229.      Step 1 -- Creating the manual:
  230.      The first step in creating a custom shell is to use your word
  231.      processor to create or edit a specialized manual containing the
  232.      names of the programs and their descriptions.  This will be
  233.      compiled by PCCNDX to appear in the description window next to
  234.      each utility, so it must exactly conform to the specifications
  235.      below.
  236.  
  237.      Each utility name in the manual must appear on a line by itself
  238.      preceded by two @@ signs.  The file descriptions should be on the
  239.      following lines.  For example,  if you have two utilities named
  240.      MYFILE.COM and YOURFILE.COM that you want included in your custom
  241.      shell program, your manual would look something like this
  242.  
  243.      @@MYFILE.COM
  244.      This is the description of MYFILE.
  245.  
  246.      @@YOURFILE.COM
  247.      This is the description of YOURFILE.
  248.  
  249.      Of course, your descriptions will be more informative than this
  250.      example.  The two @@ signs are the key that the PCCNDX program
  251.      uses to find the utility names to place in the utility name
  252.      listing window of the PCC shell program.  Your utility
  253.      descriptions, therefore, cannot contain two or more @
  254.      characters in a row or PCCNDX will get confused.
  255.  
  256.      The manual's utility descriptions should be in ASCII and have a
  257.      page width of no more than 65 characters per line, the width of
  258.      the PCC description window.  Lines longer than 65 characters
  259.      will be wrapped and spoil the appearance.  Use the manual on this
  260.      disk as a template for your own custom manual.
  261.  
  262.      Again, this manual is the key to how PCCNDX creates your
  263.      custom shell.  Not only does it contain the documentation that
  264.      appears in the text window, the @@ line also indicates the
  265.      filename that will appear in the scrollable program listing on
  266.      the left of the screen.
  267.  
  268.      Step 2 -- Compiling the manual:
  269.      Once you have created your customized manual, run the PCCNDX
  270.      program to create the customized PCC shell.  The first thing
  271.      PCCNDX will ask you is the name and path of the customized
  272.      manual that you just created.  Enter the manual's path and
  273.      filename (example: "\PCC\mymanual.doc), PCCNDX will then
  274.      read the manual, sort the @@filenames alphabetically and index
  275.      the descriptions accordingly.
  276.  
  277.      You can abort the PCCNDX program at anytime and return to DOS
  278.      by pressing Esc.  Press F1 at anytime for a summary of the
  279.      PCCNDX instructions of this README file.
  280.  
  281.      Step 3 -- Customizing the header:
  282.      At this point PCCNDX will give you the opportunity to enter up
  283.      to a 15 character title to personalize your PCC shell program.
  284.      The title you choose will appear in the top of the first line of
  285.      the PCC shell menu to the right of "PC/Computing".  If you press
  286.      Enter without typing in a name, the default title of "Utilities"
  287.      will be used and look like this:
  288.  
  289.      PC/Computing Utilities
  290.  
  291.      Step 4 -- Naming the shell:
  292.      After entering the title, PCCNDX will ask you for up to three
  293.      characters as a suffix to PCC for the name of your shell.  This
  294.      will be the name you type in to run your custom shell.  For
  295.      example, you would enter MY if you want the name of your shell
  296.      to be PCCMY.COM.  (Note that the first part of the shell name
  297.      must be PCC.)  If you press enter without entering anything,
  298.      the name of your shell will be PCC.COM.
  299.  
  300.      After entering the suffix, PCCNDX will ask you where it should
  301.      save the new custom shell.  Enter the path to the directory of
  302.      your choosing.  For example, if you want the shell saved to the
  303.      PCC directory of drive C, you would enter
  304.  
  305.      C:\PCC
  306.  
  307.      If you press Enter without entering a path, the shell will be
  308.      saved in the current directory.  Once the path is selected,
  309.      PCCNDX will create a .COM file and a .OVL file with your chosen
  310.      shell name.  The .COM file is used to load the .OVL which will
  311.      have an indexed copy of your customized manual.
  312.  
  313.      If you wish to distribute your custom shell, be sure to copy to
  314.      disk both the .COM and .OVL plus all utilities you included in
  315.      the manual.  Your manual does not need to be on the disk.  The
  316.      utility descriptions are included in the .OVL file.
  317.